Summary

• Add TTS announcement hooks for all Claude Code event types
• Enable audio notifications for task completion, tool usage, and notifications
• Cross-platform support for macOS, Linux, and Windows

Features

This PR adds the following text-to-speech announcement hooks:

• announceStop - Announces when main tasks complete
• announceSubagentStop - Announces when subagent tasks complete
• announcePreToolUse - Announces before tool execution
• announcePostToolUse - Announces after tool execution
• announceNotification - Speaks notification messages aloud

Key Features:

• 🔊 Cross-platform TTS support (macOS say, Linux espeak, Windows PowerShell SAPI)
• 🎯 Customizable messages with template variables ({toolName}, {sessionId}, {timestamp}, {message})
• 🎤 Voice selection and speech rate configuration
• 🛠️ Custom TTS command support for other systems
• 🎛️ Tool matchers for selective announcements (e.g., only announce Bash commands)
• 🔄 Backward compatibility with legacy announceTaskCompletion names

Example Usage

import { defineHooks, announceStop, announcePreToolUse } from '@timoaus/define-claude-code-hooks';

export default defineHooks({
  // Announce when tasks complete
  Stop: [announceStop({ 
    message: "Task completed for session {sessionId}",
    voice: "Samantha"
  })],
  
  // Announce before running Bash commands
  PreToolUse: [announcePreToolUse('Bash', {
    message: "Running {toolName} command"
  })]
});

Test Plan

• Tested all hooks on macOS with various configurations
• Verified template variable replacement
• Confirmed async execution doesn't block Claude Code
• TypeScript compilation passes

🤖 Generated with Claude Code